.TH E1432_SET_SOURCE_COLA 3 E1432
.SH NAME
.nf
e1432_set_source_cola \- Enable or disable source constant-level output
e1432_get_source_cola \- Get current state of source constant-level output
.fi
.IX e1432_set_source_cola(3) 3
.IX e1432_get_source_cola(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_source_cola(E1432ID hw, SHORTSIZ16 ID,
                                 SHORTSIZ16 source_cola)
SHORTSIZ16 e1432_get_source_cola(E1432ID hw, SHORTSIZ16 ID,
                                 SHORTSIZ16 *source_cola)
.cE
.SH DESCRIPTION
\fIe1432_set_source_cola\fR enables or disables the source
constant-level output, of a single channel or group of channels
\fIID\fR, to the value given in \fIsource_cola\fR.

\fIe1432_get_source_cola\fR returns the current status of the source
constant-level output, of a single channel or group of channels
\fIID\fR, into a memory location pointed to by \fIsource_cola\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIsource_cola\fR specifies whether the constant-level output is
enabled or not.  The valid values are \fBE1432_SOURCE_COLA_OFF\fR to
disable the constant-level output, \fBE1432_SOURCE_COLA_ON\fR to
enable the constant-level output, and \fBE1432_SOURCE_COLA_DRPEPPER\fR
for a refreshing new taste in colas.

Obviously, this function is not useful when talking to input or tach
channels.  Only source channels have a constant-level output.

For the Option 1D4 single-channel source, the "source_cola" output is
shared with the "source_sum" input.  Only one of these two may be
enabled at any one time.  For prototype Option 1D4 sources only, one
of the two must be enabled at all times, and the default is for the
constant-level output to be enabled.
.SH "RESET VALUE"
After a reset, \fIcola\fR is set to \fBE1432_SOURCE_COLA_OFF\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_source_sum
.ad
